home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / TeleBase / Docs / TeleBASE.doc < prev    next >
Encoding:
Text File  |  1996-09-27  |  36.0 KB  |  945 lines

  1.                                  TeleBASE Manual
  2.  
  3.                     
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                             TeleBASE Version 2.600
  28.  
  29.                        Copyright 1994 by Scott Rogerson
  30.  
  31.                        Shareware for the Amiga computer
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                                                            
  60.                          TeleBASE's killer manual                    Page 1                                  TeleBASE Manual
  61.  
  62.      PURPOSE and FEATURES:
  63.      TeleBASE is a database for addresses and phone numbers.  It will
  64.      dial  your modem for you, print envelopes, labels, and phone lists.
  65.      TeleBASE will also receive Caller ID messages with the appropriate
  66.      hard/firmware.  A full featured ARexx port is also included.
  67.  
  68.      REQUIREMENTS:
  69.      Amiga ( duh ) with ADOS release 2.04 or higher.  ( version 37+ )
  70.      Reqtools  library 2 ( version 38+ ) is recommended, but not
  71.      required.  Modem with Caller-ID option is required to get the
  72.      caller id stuff to work.  To tell if you have the correct ROMS, (on
  73.      the SupraFaxModem) Enter ATI10 from your favorite terminal program.
  74.      If you see the number 142, you got the right ones. (Tested on
  75.      SupraFaxModem V32bis)
  76.  
  77.      INSTALLATION:
  78.      Run the install utility. OR:
  79.      Just put TeleBASE in your sys:wbstartup drawer, and double click
  80.      it.  The hot-key (default) is right Amiga-F10.  ( Change it and
  81.      other stuff in the Tooltypes of the icon, or with the included
  82.      TBPrefs program )  Put the TBPrefs program in your sys:prefs
  83.      directory.
  84.  
  85.      STARTUP INSTRUCTIONS:
  86.           WORKBENCH:
  87.             Just click on it, eh? TeleBASE will bring up a file
  88.             requestor if it can't find a file called
  89.             "TeleBASE.phone" in your s: directory.  You can change
  90.             the default location of this file by changing the
  91.             tooltypes, explained below.
  92.      
  93.             ToolTypes:
  94.             You may enter one or more of the following Tooltypes
  95.             into your icon for TeleBASE. These are used when run
  96.             from the CLI _AND_ from the workbench.  If run from
  97.             the CLI, those options (command line) take precedence.
  98.             All of these are entered from the TBPrefs program for
  99.             user-friendlyness.  That's all the Prefs program DOES,
  100.             is fix up your tooltypes.  Give it a try!
  101.            The tooltypes are...:
  102.                     FILENAME=s:TeleBASE.phones
  103.                     RETURN_1=
  104.                     RETURN_2=
  105.                     RETURN_3=
  106.                     RETURN_4=
  107.                     DIALPREFIX=ATDT
  108.                     ID_INIT=AT#CID=1
  109.                     SERDEVICE=serial.device
  110.                    *ID_Name=NAME =
  111.                    *ID_Nmbr=NMBR =
  112.                    *ID_Mesg=MEST =
  113.                     CX_POPKEY=rcommand F10
  114.                     ID_START=TRUE
  115.                     LASERJET=TRUE
  116.                     NO_REQTOOLS=FALSE
  117.                     ZOOMLEFT=1000
  118.                                                                            
  119.                          TeleBASE's killer manual                    Page 2                                  TeleBASE Manual
  120.  
  121.                     ZOOMTOP=1000
  122.                     WINLEFT=1000
  123.                     WINTOP=1000
  124.                     LABELHEIGHT=5
  125.                     LABELWIDTH=35
  126.                     LABELSACROSS=3
  127.                     BETWEENDOWN=2
  128.                     BETWEENACROSS=2
  129.                     HIDE_WARN=FALSE
  130.                     STEXT=Incoming call from %n.
  131.                     SPEAK=TRUE
  132.                     CALLPOP=TRUE
  133.                     SER_UNIT=0
  134.                     FONTSIZE=11
  135.                     LEFTMARGIN=0
  136.                     FILE=S:TeleBASE.phones
  137.                     DIALPREFIX=ATDT
  138.  
  139.             If  you'd  like,  you  can have more than one icon for
  140.             TeleBASE, and just have one copy of the program
  141.             somewhere in your path.  This allows you to have more
  142.             than one configuration of the program, without having
  143.             to change the Tooltypes in the icon, or enter the
  144.             parameters from the command line.  Just click on the
  145.             appropriate icon, or type TeleBASE from the directory
  146.             where the desired icon is located.
  147.  
  148.             The following tooltypes have no CLI equivalant.
  149.  
  150.             CALLPOP=TRUE
  151.             With this set to true, the main window will pop up,
  152.             and come to the front, if an incoming call is found in
  153.             your database.
  154.  
  155.             SPEAK=TRUE
  156.             Turns on the Speaking feature.  With this set to TRUE,
  157.             your amiga will speak the text indicated by the option
  158.             STEXT.
  159.  
  160.             STEXT=<STRING>
  161.             This is what your Amiga will say, when a call comes
  162.             in.  You can use some pre-defined variables in this
  163.             string.  These varibles will be replaced with the
  164.             following:
  165.  
  166.             %p - phone number of the incoming call.
  167.  
  168.             %n - name as it comes from the phone company.
  169.  
  170.             %l - lastname of corrisponding record
  171.  
  172.             %f - first name of corresponding record
  173.  
  174.             %c - company name of corresponding record
  175.  
  176.                If you do not have the incoming call already in
  177.                                                                            
  178.                          TeleBASE's killer manual                    Page 3                                  TeleBASE Manual
  179.  
  180.             your database, %l, %f, and %c will be UNKNOWN.  (So,
  181.             the computer will say "UNKNOWN", in this case)
  182.                
  183.                If you don't have 'Deluxe caller id' you will not
  184.             get the %n variable.  Call your phone company for
  185.             details.
  186.  
  187.             example:
  188.             Say a call comes in from 4075551212 which you have in
  189.             your database.  If this persons name was filled out
  190.             like: Lastname = Smith, and Firstname = John.  You
  191.             could have SText set up with:
  192.             There is an incoming call from %f %l, at %p.
  193.  
  194.             In this case, your Amiga would say, "There is an
  195.             incoming call from John Smith, at 4075551212".
  196.  
  197.             CLI
  198.             There are quite a few arguments that may be passed to
  199.             Telebase from the CLI.  Entering 'Telebase ?' will get
  200.             you a command template.  It looks like this:
  201.  
  202.       TeleBASE 2.6xx3 c 1992-94 by Scott Rogerson
  203.       FileName=F/K,Name=N/K,Call1=C1/S,Call2=C2/S,LeftPos=LP/N/K,
  204.       TopPos=TP/N/K,LeftZoom=LZ/N/K,TopZoom=TZ/N/K,CallLeft=CL/N/K,
  205.       CallTop=CT/N/K,NoPopUp/S,DialPrefix=DP/K,DialNumber=DN/K,
  206.       ID_NMBR/K,ID_Name/K,ID_Mesg/K,LabelHeight=LH/N/K,
  207.       LableWidth=LW/N/K,LabelsAcross=LA/N/K,BetweenDown=BD/N/K,
  208.       LeftMargin=LM/N/K,BetweenAcross=BA/N/K,LaserJet/S,ReturnAdd1=R1/K,
  209.       ReturnAdd2=R2/K,ReturnAdd3=R3/K,ReturnAdd4=R4/K,AddresseeOver/N/K,
  210.       AddresseeDown/N/K,ID_Init=II/K,ID_Start=IS/S,SerDevice=SD/K,
  211.       Unit/N/K,No_ReqTools/S,Hide_Warn/S,FontName=FN/N/K,FontSize=FS/N/K
  212.  
  213.        Now, to explain each one...:
  214.      FILENAME=F/K,       ( defaults to: s:TeleBASE.phone )
  215.          This is a filename to load.
  216.  
  217.      NAME=N/K,           ( defaults to: Nothing! )
  218.          A string you would like TeleBASE to search for at startup.
  219.  
  220.      CALL1=C1/S,         ( defaults to: off )
  221.          A switch to tell telebase to call entry at startup. Use with
  222.          the NAME switch above.  More explanation later See Example
  223.          below.  This switches calls first phone entry. ( Phone 1 )
  224.  
  225.      CALL2=C2/S,         ( defaults to: off )
  226.          Same as above, but calls second phone entry. ( Phone 2 )
  227.  
  228.      LEFTPOS=LP/N/K,     ( defaults to: 0 )
  229.          Number indicating the left position of the main window.
  230.  
  231.      TOPPOS=TP/N/K,      ( defaults to: 0 )
  232.          Number indicating the top position of the main window.
  233.  
  234.      LEFTZOOM=LZ/N/K,    ( defaults to: 0 )
  235.          Number indicating the left position of the main window when
  236.                                                                            
  237.                          TeleBASE's killer manual                    Page 4                                  TeleBASE Manual
  238.  
  239.          it's zipped. (Minimized)
  240.      
  241.      TOPZOOM=TZ/N/K,     ( defaults to: 0 )
  242.          Number indicating the top position of the main window when
  243.          it's zipped. (Minimized)
  244.      
  245.      CALLLEFT=LP/N/K,     ( defaults to: 0 )
  246.          Number indicating the left position of the call window.
  247.  
  248.      CALLTOP=TP/N/K,      ( defaults to: 0 )
  249.          Number indicating the top position of the call window.
  250.      
  251.      NOPOPUP/S,          ( defaults to: popup )
  252.          Tells TeleBASE to startup, but not to show it's window.
  253.      
  254.      DIALPREFIX=DP/K,    ( defaults to: ATDT )
  255.          Set the Dial prefix.  (ATDT, ATDT*67, .... whatever )
  256.      
  257.      DIALNUMBER=DN/K,    ( N/A )
  258.          A string to send to the modem, and then quit.
  259.      
  260.      ID_NMBR/K           ( defaults to: 'NMBR = ' )
  261.          Should be the string that your modem sends before the actual
  262.          number. Note that this string includes a space AFTER the equals
  263.          sign.
  264.      
  265.      ID_NAME             ( defaults to: 'NAME = ' )
  266.          Should be the string that your modem sends before the name.
  267.          Note that this string includes a space AFTER the equals sign.
  268.      
  269.      ID_MESG             ( defaults to: 'MESG = ' )
  270.          Should be the string that your modem sends before the data.
  271.          Note that this string includes a space AFTER the equals sign.
  272.      
  273.      LABELHEIGHT=LH/N/K, ( defaults to: 5 )
  274.          Height of printer labels in characters
  275.      
  276.      LABELWIDTH=LW/N/K,  ( defaults to: 35 )
  277.          Width of printer labels in characters.
  278.      
  279.      LABELSACROSS=LA/N/K,( defaults to: 3 )
  280.          How many labels across a page. ( 1-3 only )
  281.      
  282.      BETWEENDOWN=BD/N/K, ( defaults to: 3 )
  283.          Number of characters between labels. Top to bottom.
  284.      
  285.      BETWEENACROSS=BA/N/K,( defaults to: 3 )
  286.          Number of characters between labels. Side to side.
  287.      
  288.      LEFTMARGIN/N/K
  289.          Enter the number of characters from the left margin to start
  290.          printing labels
  291.  
  292.      LASERJET/S
  293.          Switch that will select the paper type of Envelope#10, and
  294.          landscape mode on a laserjet printer.
  295.                                                                            
  296.                          TeleBASE's killer manual                    Page 5                                  TeleBASE Manual
  297.  
  298.      
  299.      RETURNADD1=R1/K
  300.      RETURNADD2=R2/K
  301.      RETURNADD3=R3/K
  302.      RETURNADD4=R4/K
  303.          Strings to put on each line of return address for envelopes.
  304.      
  305.      ADDRESSEEOVER/K
  306.          Number of characters to the right of the left edge to put the
  307.          Addressee on an envelope.
  308.  
  309.      ADDRESSEEDOWN/K
  310.          Number of characters below top line at which to print the first
  311.          line of the Addressee, on an envelope.
  312.      
  313.      ID_INIT=II/K,       ( defaults to: AT#CID=1\r )
  314.          String to enable Caller ID.
  315.      
  316.      ID_START=IS/S,      ( defaults to: off )
  317.          Switch telling TeleBASE to turn on Caller ID at startup.
  318.      
  319.      SERDEVICE=SD/K,     ( defaults to: serial.device )
  320.          Serial device to monitor. (defaults to serial.device)
  321.      
  322.      UNIT/N/K            ( defaults to: 0 )
  323.          Serial device unit number.
  324.      
  325.      NO_REQTOOLS/S,      ( defaults to: off )
  326.          Tells TeleBASE to ignore reqtools.library.
  327.      
  328.      HIDE_WARN/S:        ( defaults to: off )
  329.          Tells telebase to warn you if you hide the window without
  330.          saving changes.  TB will warn you if you try to QUIT, but
  331.          this is a bit of added protection.
  332.  
  333.      FONTNAME=FN/K       ( defaults to: Topaz.font (yuk) )
  334.          Font you wish to use.  Not all fonts look superb. This font is
  335.          maybe independent of WorkBench's Default, and system fonts.
  336.      
  337.      FONTSIZE=FS/N/K     ( defaults to: 8 )
  338.          Font size you wish to use.  If that particular size is not
  339.          found, it will be generated by the library.
  340.  
  341.           Example: TeleBASE f=s:Business.phone n=Roge*n DP=ATDP c1
  342.      
  343.      WildCards may be used in the record to be searched for, as shown
  344.      above. The entry shown above will load the file "Business.phone" in
  345.      the s: directory, go to the first name it finds that starts like
  346.      Roger, and ends with a 'n', and call that entry with the dialing
  347.      prefix of "ATDP", and then exit.
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                                                            
  355.                          TeleBASE's killer manual                    Page 6                                  TeleBASE Manual
  356.  
  357.  
  358.      A suggestion might be to enter into your shell-startup file
  359.      something _LIKE_ the following:
  360.  
  361.                            alias tb c:TeleBASE n=[]
  362.                                    _AND/OR_
  363.                          alias call  c:TeleBASE c1 n=[]
  364.                                    _AND/OR_
  365.                           alias Dial c:TeleBASE DN=[]
  366.      
  367.      This will allow you to enter "Call Scott", "Dial 555-1212", or
  368.      "tb roger", and the machine will know what you mean.
  369.  
  370.  
  371.      PROGRAM OPERATION:
  372.      Main Window:
  373.      If TeleBASE is set up to open a window on startup, this is the one
  374.      you will see.  It consists of String gadgets for storing
  375.      information about each record, and a set of button gadgets along
  376.      the right edge of the window.
  377.  
  378.      The only string gadget that requires an explanation ( I think ), is
  379.      the Caller ID string gadget.  This gadget should hold only the
  380.      digits in a phone number as it is displayed in the Call Window.
  381.      For further explanation, see the Match gadget, in the Callwindow,
  382.      below.
  383.  
  384.           Follows a description of each button in the main window:
  385.      Add:
  386.           This button creates a new, blank record for you to fill in.
  387.      Only one blank record may be in the database at any one time, and
  388.      they are purged from the database whenever you save your file.
  389.  
  390.      Delete:
  391.           This button causes the current, displayed record to become an
  392.      EX-record.  The database in the sky comes to mind.... You must
  393.      confirm delete actions, unless issuing the command from Arexx.
  394.  
  395.      Search:
  396.           Clicking this button will bring up a requester / window that
  397.      will ask you for a word or expression to look for.  Wildcards may
  398.      be entered, and a * is assumed at the end of whatever you type.
  399.      Therefore, typing Tibb will find Tibbit. Scans all fields.
  400.      
  401.      Tag:
  402.           This button will clear all of the string gadgets, and allow
  403.      you to put different criteria in any/none/all string gadgets.  Only
  404.      items entered will be searched.  So, for instance, if you wanted to
  405.      'tag' all zip codes starting with a 770, you could enter 770* in
  406.      the zip code field, and they would be tagged for you.  After you've
  407.      entered all of the search criteria in the string gadgets, click on
  408.      the Tag button again.  All of the records that have matched your
  409.      entered criteria will be 'tagged', and you may view them
  410.      exclusively by using the NextTag, and BackTag buttons.
  411.  
  412.  
  413.                                                                            
  414.                          TeleBASE's killer manual                    Page 7                                  TeleBASE Manual
  415.  
  416.      A NOTE ABOUT WILDCARDS:
  417.           You may use the '*' and the '?' as wild cards in your search.
  418.      The '?' will match any ONE character, and the '*' will match any
  419.      number of any character.  The search is NOT case sensitive.
  420.  
  421.      call1:
  422.           This will send the string, "ATDT" ( unless otherwise specified
  423.      by you in the startup options ) plus whatever you have entered into
  424.      the 'Phone 1' field out to your modem. Make sure you have your
  425.      preferences set up correctly for your modem. If you have your
  426.      preferences set up for a 19200 baud modem, and you have your Amiga
  427.      hooked up to a 1200 baud modem ( or anything less than reflected by
  428.      prefs ), this program will NOT WORK!
  429.  
  430.      If all is well, when you click on "CALL (x)", you will see a
  431.      requestor telling you to pick up the phone. Make sure you give your
  432.      modem  ample time to dial the number. When you click "Okay", your
  433.      modem will hang up, so you should have already picked up the phone
  434.      by then. If the modem is not dialing, make sure you are running
  435.      IPREFS in your startup-sequence.
  436.  
  437.      NOTE:
  438.      Putting parenthesis, and hyphens in your phone number has no effect
  439.      on the dialing of the modem.  The modem will ignore all such eye
  440.      fodder.  So, entering your phone numbers like, 1(407)555-1212, is
  441.      OKay!  You may also allow for pauses with a comma to access
  442.      computerized phone networks where touch-tone entry of extensions
  443.      is available, or to send a password, and collect your voice mail.
  444.  
  445.      Call2:
  446.           Works just like the above "call 1" option, only it uses the
  447.      phone number in the "Phone 2" gadget.
  448.  
  449.      Print:
  450.           Clicking on this button opens a moderately sized can o' worms,
  451.      and a rather small window.  This window has two sets of radio style
  452.      buttons at the top.  One of which is to tell TeleBASE WHAT to
  453.      print, and the other is to tell TeleBASE WHICH records to print.
  454.  
  455.               The WHAT gadgets consists of the following choices:
  456.  
  457.          Phonelist:
  458.             Prints Names and numbers only. Like:
  459.             Firstname Lastname............................Number
  460.  
  461.          Labels
  462.             Prints up to three columns of labels to your printer,
  463.             or to a file.
  464.          Whitepages
  465.             A rather silly option, suggested by a paying customer.
  466.             Anyway, it prints something analogous to what's found
  467.             in a whitepages phone directory.  It's like a
  468.             phonelist, but prints address info, too.  ( Like the
  469.             WHITEPAGES, sheesh! )
  470.  
  471.  
  472.                                                                            
  473.                          TeleBASE's killer manual                    Page 8                                  TeleBASE Manual
  474.  
  475.          Envelope
  476.             Prints the return address specified by the
  477.             RETURNADDRESS1-4 tooltypes, and whichever record is
  478.             current in the ADDRESSEE portion of the envelope.
  479.             Settings for these buggers is rather difficult to
  480.             'splain, but I'll do my best....  If you have a printer
  481.             that supports printing sideways, (Like a laserjet) you
  482.             should select the appropriate option (LaserJet) in the
  483.             TBPrefs program.  This will cause the printer to ready
  484.             itself for manual feed, and wait for you to install an
  485.             envelope, and press the ONLINE button.  Jeez, that
  486.             makes buying a laser printer worth it RIGHT THERE.. ;).
  487.             If you're using a proportional font in your printer,
  488.             you should set the ADDRESSEEOVER tooltype to a rather
  489.             high value. ( Spaces don't take up a lot of room. ) 95
  490.             works good for me.  The ADDRESSEEDOWN should be set to
  491.             somewhere around 5.  This is the distance between the
  492.             last line printed in the Return Address portion and the
  493.             first line of the Addressee portion.  ( Make sense? )
  494.             If you are NOT using a laser printer, you'll most
  495.             likely want to change the ADDRESSEEOVER tooltype to
  496.             somewhere around 40.  ( Depending on the type of
  497.             envelope you use ) The program was tested with #10 size
  498.             envelopes, mostly, but should do most other sizes
  499.             without trouble.
  500.  
  501.          Full list
  502.             This option just prints EVERYTHING in a record.
  503.  
  504.                        Now, for the WHICH radio gadget:
  505.          All
  506.             Pretty obvious, eh?
  507.  
  508.          Tagged:
  509.             Prints only the records with the 'tag' checkbox marked.
  510.             er ah...(ahem) checked.
  511.  
  512.          Current:
  513.             Prints only the current record. (showing)  This is the
  514.             only setting possible when you are printing envelopes.
  515.  
  516.      Open:
  517.         To open a new file.  Come on, you've done this before... If
  518.         you've changed your database, and you ask to load another,
  519.         you'll be asked if you're sure.  Are you?
  520.  
  521.      Save
  522.         See above...  This is baby stuff.  There should be little
  523.         problems here.
  524.  
  525.      Hide:
  526.         Hides the main window. Maybe also be done by: Clicking the
  527.         CloseWindow gadget Pressing [ESC] key while no string gadgets
  528.         active, and pressing the [ESC] key TWICE, when a string gadget
  529.         IS active.
  530.  
  531.                                                                            
  532.                          TeleBASE's killer manual                    Page 9                                  TeleBASE Manual
  533.  
  534.      List:
  535.         Opens the Incoming Call window. Explained below.
  536.  
  537.      CID:
  538.         Starts a new process that intercepts Caller ID messages.
  539.  
  540.      next:
  541.         Makes the next record in the database the current (displayed)
  542.         record.
  543.  
  544.      back:
  545.         Same as above, but previous record.
  546.  
  547.      NextTag:
  548.         Same as next, but looks for 'tag' gadget checked.
  549.  
  550.      BackTag:
  551.         Same as back, but looks for 'tag' gadget checked.
  552.  
  553.      ABOUT:
  554.         Pressing the HELP key will give you a small blurb about the
  555.         program version number, the name of the AREXX port (TBase), and
  556.         name of the wonderful, and modest programmer.
  557.  
  558.      Registration Info:
  559.         A menu item in the Project menu, will tell you how to register
  560.         this program.  A registration form is included in the archive.
  561.  
  562.      Cursor placement:
  563.         You may use the return key, the up/down arrow keys, and
  564.         tab/shift-tab to move the cursor up/down through the fields.
  565.         Pressing the [ESC] key terminates all gadget activation. There
  566.         is no need to press return in a string gadget, for changes to
  567.         take effect.  To advance the record, or to go back to a previous
  568.         record while the cursor is in a string gadget, you may press
  569.         alt, and a cursor key, or just press right amiga- n, or b.
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                                                            
  591.                         TeleBASE's killer manual                    Page 10                                  TeleBASE Manual
  592.  
  593.      Call Window:
  594.      This window lists all the Caller ID messages intercepted from the
  595.         modem.  They take the form:
  596.         NUMBER      NAME           DATE           TIME
  597.         
  598.         The date and time are taken from the Amiga's clock, not the
  599.         incoming data.  I've often found it inaccurate.
  600.  
  601.      Listview Gadget:
  602.         The listview gadget is where the actual incoming calls are
  603.         displayed.  If you click on one of these calls, you can then
  604.         perform a function on it, such as match, add, or kill.
  605.  
  606.      Match:
  607.         This gadget will search the database for a record that has this
  608.         phone number.  The search is done in the Call ID string gadget
  609.         in the main window.  The data in this string gadget should be
  610.         the number ONLY.  So, a phone number displayed like
  611.         (407)555-1212 will match a Caller ID string gadget containing
  612.         4075551212.  Some local phone companies only sends seven digits
  613.         for the phone number, when the call is local.  If your phone
  614.         company sends data this way ( You'll know as that's all that
  615.         appear in the Listview gadget) you should enter only that data
  616.         in the Caller ID string gadget, for local calls.  So, if your
  617.         area code is 407, and you get a local call from 555-1212, you
  618.         should place 5551212 in the Caller ID string gadget of the
  619.         appropriate record.
  620.  
  621.      add:
  622.         If you haven't stored an incoming call in your database, you may
  623.         have TeleBASE add it's known data for you in a new record, by
  624.         pressing on the add gadget.
  625.  
  626.      Add All:
  627.         This gadget is the same as above, but performs the operation on
  628.         all calls listed in the Listview gadget.
  629.  
  630.      kill:
  631.         Deletes the currently displayed call from the listview gadget.
  632.  
  633.      Kill All:
  634.         Deletes all calls from the listview gadget.
  635.  
  636.      Note:
  637.         If you do not have 'Deluxe' caller id, you will not get data
  638.         from the phone company for NAME.  If you do not have this
  639.         optional feature, use the POPCALL=TRUE tooltype, to see WHO is
  640.         calling.  TeleBASE will print UNKNOWN in the Call Window, but if
  641.         this caller is in your database, you can still see who is
  642.         calling without paying the additional money to your phone
  643.         company.  If you decide to add this feature to your phone line,
  644.         a name will appear under the NAME heading in the Call window.
  645.         Deluxe caller id is only available in some areas. Ask your phone
  646.         company for details.
  647.  
  648.  
  649.                                                                            
  650.                         TeleBASE's killer manual                    Page 11                                  TeleBASE Manual
  651.  
  652.  
  653.      CALLER ID NOTES:
  654.         TeleBASE will use owndevunit.library if it finds it in your
  655.         libs: directory.  With this library installed, TeleBASE will
  656.         give up the serial port whenever an ODU aware program (Like
  657.         Terminus) wants it.  You needn't do anything to make this
  658.         happen, it just does. Trust me!  When you quit this ODU aware
  659.         program, TeleBASE will quietly take control of the serial port,
  660.         again.  If you use a program that is NOT ODU aware, you should
  661.         make a script file to run that program, that will first turn off
  662.         the caller id process of TeleBASE.  Here is a script file I use
  663.         for running Aladdin.:
  664.         
  665.         rx "if show('p', 'TBASE') then address TBASE CID_OFF"
  666.         Aladdin
  667.         rx "if show('p', 'TBASE') then address TBASE CID_ON"
  668.      
  669.         Here is another example. This also allows arguments to be sent
  670.         to Trapdoor, after shutting down TeleBASE, and then restarts it.
  671.         
  672.         .bra {
  673.         .ket }
  674.         .key arg
  675.         rx "if show('p', 'TBASE') then address TBASE CID_OFF"
  676.         mail:bin/trapdoor {arg}
  677.         rx "if show('p', 'TBASE') then address TBASE CID_ON"
  678.      
  679.         To run this script, for Trapdoor, enter your commands to
  680.         Trapdoor in quotation marks.  Like:
  681.         
  682.         TD.Script "call boss"
  683.  
  684.      AREXX:
  685.         You can send ARexx commands to TeleBASE via a port named TBASE.
  686.         Each command is listed below:
  687.  
  688.      NEXT
  689.         Makes next record in the file current. If there is NO NEXT
  690.         record, ( ie: end of list ) NEXT will return 5. Else, it
  691.         returns 0. ( RC_OK )
  692.  
  693.      BACK
  694.         Similar to NEXT command, but makes previous record current.
  695.  
  696.      NEXTCALL
  697.         Makes next call entry active.
  698.  
  699.      BACKCALL
  700.         Makes previous call entry active.
  701.  
  702.      NEXTTAG
  703.         Makes next entry in list with the TAG checkbox active.
  704.  
  705.      BACKTAG
  706.         Makes last entry in list with the TAG checkbox active.
  707.  
  708.                                                                            
  709.                         TeleBASE's killer manual                    Page 12                                  TeleBASE Manual
  710.  
  711.      TAG
  712.         Tags the current record.
  713.  
  714.      UNTAG
  715.         Untags the current record.
  716.  
  717.      TOGGLETAG
  718.         Toggles the status of the tag checkbox of the current record.
  719.  
  720.      START
  721.         Makes the first record the current record.
  722.  
  723.      END
  724.         Makes the last record the current record.
  725.  
  726.      GETVAR
  727.         Places the values of the current record's fields into the
  728.         following variables. You may access these variables through
  729.         ARexx scripts.  Always use uppercase when referencing these
  730.         variables.
  731.      
  732.         LNAME        FNAME          COMPANY         ADD1
  733.         ADD2         CITY           STATE           ZIP
  734.         PHONE1       PHONE2         COMMENT
  735.      
  736.         The above variables correspond to the appropriate fields of the
  737.         current record, in the main window.
  738.         NUMRECORDS    <= This will contain the number of records in the
  739.         database at any given time.  If you obtain the variable, and
  740.         then add a record, you will need to do another GetVar from arexx
  741.         before NUMRECORDS is updated.
  742.         RECORDNUM    <= This variable contains the record number of the
  743.         current record.  This number corresponds to the number shown in
  744.         the title bar of the main window.  Like the above NUMRECORDS
  745.         variable, if you issue a NEXT command, the value of RECORDNUM
  746.         will still contain the old value, until another GETVAR command
  747.         is issued.
  748.      
  749.         The following variables come from the data received via the
  750.         modem.  This is your Caller-ID information for the currently
  751.         selected call. Calls are 'selected' in ARexx via the NEXTCALL,
  752.         and BACKCALL commands.  The following variables, with the
  753.         exception of CALLNUM, are READ ONLY!  You can of course change
  754.         their values in your AREXX scripts, but if you make another call
  755.         to GETVAR, the values will be replaced with TeleBASE's idea of
  756.         correctness.
  757.         C_NAME       <= The value received from the phone company.
  758.                          ( caller's name )
  759.         C_NUM        <= The phone number of the incoming call formatted
  760.                          like: (XXX)XXX-XXXX
  761.         C_DATE       <= The date the current call was received.
  762.         C_TIME       <= The time the current call was received.
  763.         C_RAW        <= Raw phone number as received. In the format:
  764.                          XXXXXXXXXX
  765.         C_DATA       <= This is all of the above (sans C_RAW)
  766.                          variables, put together exactly as seen in the 
  767.                                                                            
  768.                         TeleBASE's killer manual                    Page 13                                  TeleBASE Manual
  769.  
  770.                          calls window. (NUMBER NAME DATE TIME)
  771.         NUMCALLS     <= Contains the number of calls currently in the
  772.                          data base.
  773.      
  774.         CALLNUM      <= Contains the number of the currently selected
  775.                          caller.
  776.  
  777.      SENDVAR
  778.         This will put the values of the variables mentioned above into
  779.         the current record.  example:
  780.         /* Arexx stuff */
  781.         PHONE1 = '555-1212'
  782.         SENDVAR           /* Ta daaa! */
  783.  
  784.      QUIT
  785.         This quits just like it would, had you selected it from the
  786.         Menu.
  787.  
  788.      QUIT!
  789.         This quits suppressing all "Not Saved" requestors, for
  790.         unattended operation.
  791.  
  792.      SEARCH [argument]
  793.         Text to search for in all fields in the list.  Current record
  794.         will be the first occurrence of such a match. ( if found )
  795.  
  796.      SHOWMAIN
  797.         Brings up TeleBASE's main window
  798.  
  799.      HIDEMAIN
  800.         Hides TeleBASE's main window
  801.  
  802.      SHOWCALL
  803.         Brings up TeleBASE's call window.
  804.  
  805.      HIDECALL
  806.         Hides TeleBASE's call window.
  807.  
  808.      OPEN [argument]
  809.         loads the file 'argument'. Include complete path.  Don't include
  810.         the []'s.
  811.  
  812.      SAVE
  813.         saves current file into default, or last saved filename.
  814.  
  815.      SAVEAS [argument]
  816.         saves file under the name 'argument'. Include complete path.
  817.  
  818.      ADD
  819.         Allocates new record, and makes it the current record. It will
  820.         also be the first record in the list, until a NEXT, BACK,
  821.         NEXTTAG BACKTAG, or RESORT command is issued.
  822.  
  823.      DELETE
  824.         Deletes current record. No questions asked.
  825.  
  826.                                                                            
  827.                         TeleBASE's killer manual                    Page 14                                  TeleBASE Manual
  828.  
  829.      CALL1
  830.         Calls the Phone1 entry ( with requester )
  831.  
  832.      CALL2
  833.         Calls the Phone2 entry ( with requester )
  834.  
  835.      CID_ON
  836.         Activates Caller ID
  837.  
  838.      CID_OFF
  839.         Stops Caller ID search
  840.  
  841.      RESORT
  842.         Resorts the list. This is most likely not needed by most, but
  843.         added just to make it possible to sort the database, without the
  844.         rexx script having to do a next, or something.
  845.      
  846.      Note to Arexx programmers:  One thing I should mention, is that I
  847.         don't know much about Arexx.  If there is an obvious command, or
  848.         some other Arexx feature that I have not made use of, tell me
  849.         about it.  I'll do what I can to make it work for you.  I know
  850.         how to react to messages from Arexx, but I've just never taken
  851.         the time to learn Arexx, so I don't see the obvious sometimes.
  852.  
  853.      Just for fun, here's a rexx script that prints all known data about
  854.         incoming calls.
  855.  
  856.      /* Prints all TBase variables relating to incoming calls */
  857.      address tbase  /* Talk with TeleBASE */
  858.      GETVAR         /* Fill rexx variables with current data */
  859.      callnum = 1    /* Set the current call to the first in the list */
  860.      sendvar        /* Tell telebase about it. */
  861.      do forever
  862.        GetVar       /* Get variables from Telebase */
  863.        say ''
  864.        say 'C_NAME is ' C_NAME
  865.        say 'C_DATA is ' C_DATA
  866.        say 'C_TIME is ' C_TIME
  867.        say 'C_DATE is ' C_DATE
  868.        say 'C_RAW is '  C_RAW
  869.        say 'C_NUM is '  C_NUM
  870.        say 'NumCalls is ' numcalls
  871.        say 'Caller number is ' callnum
  872.        if callnum = numcalls then exit /* Quit when done */
  873.        nextcall     /* Go to next call in list */
  874.      END
  875.      OTHER STUFF:
  876.         TeleBASE was written and compiled with SAS C Version 6.51.
  877.         This program is SHAREWARE. If you find that TeleBASE meets your
  878.         needs, please consider registering it. Just send me any amount
  879.         of money over $15 US along with your name and address, ( Use the
  880.         included order form, if possible) and I'll put you in MY
  881.         TeleBASE file. This way I can send you updates, as they're
  882.         available. You might also include suggestions for future
  883.         releases. Registered users have a VERY loud voice with
  884.         when/what/how things get implemented.
  885.                                                                            
  886.                         TeleBASE's killer manual                    Page 15                                  TeleBASE Manual
  887.  
  888.  
  889.      Send bug reports, registrations, and suggestions to:
  890.         Scott Rogerson
  891.         758 Merrimac Street SE
  892.         Palm Bay, Florida 32909-4917
  893.      
  894.      I can also be reached via:
  895.         FIDO     => 1:374/85.2
  896.         GEnie    => S.Rogerson
  897.         Internet => s.rogerson@genie.geis.com
  898.      
  899.      Subliminal message:
  900.         Send me all your cash.
  901.  
  902.      Thanks to:
  903.         Mark  Rogerson-> general help, suggestions, and not killing me 
  904.                          at age 5.  ( or age 6, or age 7....)
  905.         David Steidley-> Thanks for the ARexx lesson, but I need more
  906.         Bob Starkey   -> testing, suggesting, and motivating.
  907.  
  908.      LICENSE, and other legal crap:
  909.         This material is c Copyright 1992-94 by Scott Rogerson.
  910.         Reqtools is c Copyright by Nico Francois
  911.         owndevunit.library is c Copyright by Christopher Wichura
  912.         Terminus is c Copyright by Jack Radigan
  913.         Trapdoor is c Copyright by Maximilian Hantsch & Martin Laubach
  914.  
  915.      --   All rights reserved.
  916.         This  may be distributed freely as long as the following
  917.      restrictions are met:
  918.         The  distributor  may charge a nominal fee to recover
  919.      distribution costs.
  920.         The  distributor  agrees  to  cease  distributing  the  programs
  921.      and data involved  if requested to do so by the author.  You may
  922.      copy and distribute verbatim  copies  of the program's executable
  923.      code and documentation as you receive   it,   in   any   medium,
  924.      provided  that  you  conspicuously  and appropriately  publish
  925.      only  the  original,  unmodified  program, with all copyright
  926.      notices and disclaimers of warranty intact and including all the
  927.      accompanying  documentation, example files and anything else that
  928.      came with the original.
  929.           The  author will not be liable for any damage arising from the
  930.      failure of this  program to perform as described, or any
  931.      destruction of other programs or  data  residing on a system
  932.      attempting to run the program.  While I know of  no  damaging
  933.      errors, the user of this program uses it at his or her own risk.
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.                                                                            
  945.                         TeleBASE's killer manual                    Page 16